home *** CD-ROM | disk | FTP | other *** search
/ Aminet 30 / Aminet 30 (1999)(Schatztruhe)[!][Apr 1999].iso / Aminet / mus / misc / PLSTsearch.lha / PLSTsearch.txt < prev    next >
Text File  |  1999-01-18  |  4KB  |  97 lines
  1.  
  2.  
  3.                               PLSTsearch v1.1
  4.                               ~~~~~~~~~~~~~~~
  5.  
  6.                         - by Ola Ekström (c) 1999 -
  7.             - Developed in C using the DICE Freeware compiler -
  8.  
  9.  
  10. IMPORTANT!:
  11. ~~~~~~~~~~~
  12.     You use this program totally on your own risk. I am not
  13.     responsible for anything that this program does to your hardware
  14.     and/or software. Remember that it is always a healthy thing to 
  15.     make backups of your data on a regular basis.
  16.  
  17.     PLSTsearch is Freeware, this means that it may be distributed
  18.     and used freely, but it may not be sold for money.
  19.  
  20.  
  21.  
  22. What is PLSTsearch and how do I use it?
  23. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  24.     PLSTsearch is a search-tool for plst-files (also known as
  25.     Preset-lists) produced by Protracker and it's close relatives on
  26.     Amiga compatible computers. It can only be run from the CLI/Shell
  27.     and use this command format: PLSTsearch <plst-file>
  28.     [search-string]. You must replace <plst-file> with the full path
  29.     to where your plst is stored. Directories defined by the path
  30.     command will not be checked. You will have to replace
  31.     [search-string] with any string that you would like to search the
  32.     plst for. I.e. if you search for "snare", PLSTsearch will report
  33.     back all entries found with where "snare" is part of the name.
  34.     If you don't specify a search-string, the whole plst will be
  35.     listed. If a match is found, PLSTsearch will print the name of the
  36.     sample, the disk it is stored on, the length of the sample, the
  37.     finetune value and its repeat and replen offsets. Unlike
  38.     Protracker and friends this information is displayed in decimal
  39.     format. PLSTsearch does not support wild-cards or other advanced
  40.     forms of searching at the moment. If your searchstring contains
  41.     spaces you must enclose it within quotation marks. Like this:
  42.     "string.with a.space.in.it".
  43.  
  44.  
  45. Why?
  46. ~~~~
  47.     Why write a program like this, you might ask yourself. The plst
  48.     is already arranged in alphabetical order... Well, that is true,
  49.     but when your plst grows bigger, it will be harder and harder
  50.     to remember the names of individual samples. If you have 30
  51.     snare-drum samples called things like: bigsnare, smallsnare,
  52.     shortsnare etc. it will not help you very much if they are
  53.     listed alphabeticaly. My plst contains about 600 entries and 
  54.     I don't think it's very large, yet it's hard to locate things
  55.     sometimes. I can imagine how hard it would be to find one's way
  56.     around a plst with a couple of 1000 entries. If you only remember
  57.     a part of a name or want to list samples of a special type, you
  58.     can use PLSTsearch.
  59.  
  60.  
  61. News for version 1.1
  62. ~~~~~~~~~~~~~~~~~~~~
  63.     PLSTsearch now displays all data available in each record, except
  64.     the volume byte. I understand that you can't save volume on any
  65.     freestanding sample, it is only saved in the modules, so this byte
  66.     is always set to $40 in the plst. I also changed the memoryhandling
  67.     so that the program doesn't use the disk so much.
  68.  
  69. Last Words:
  70. ~~~~~~~~~~~
  71.     For this version of PLSTsearch I supply the sources with the rest
  72.     of the program. This is because I got such a nice e-mail from a
  73.     dutch genleman asking me to make the sources available so that the
  74.     programs stored on AmiNet could be compiled and used on 'the new
  75.     Amiga', whatever that is... That gave me a reason to dig up the
  76.     old Amiga 500 from the closet it was in, and while I was at it,
  77.     I thought that I might just as well tidy up the 1.0 sources a bit.
  78.     Thats why I make a new release instead of just releasing the
  79.     sources for the 1.0 version. So, now everyone can make any changes
  80.     they want to the program (why not write a nice GUI for it?).
  81.     If you do make any changes and spread them it would be nice if
  82.     you gave me credit for the original program. PLSTsearch doesn't
  83.     use any Amiga specific code, so it might be posible to port it to
  84.     other platforms. I have seen tracker-clones on the Atari ST for
  85.     instance, maybe it can be used there as well.
  86.  
  87.     I would like to say thanks to everyone that makes software that
  88.     works on an Amiga 500 / MC68000 system!
  89.  
  90.     If you want to contact me for bug reports or just to tell me
  91.     what you think of the program, I can be reached by e-mail on
  92.     the following address: knaster74@hotmail.com
  93.  
  94.     I hope you will find PLSTsearch usefull!
  95.  
  96.                     / Ola Ekström, January 17 1999.
  97.